home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 November / macformat-018.iso / Utility Spectacular / Text / Emacs-1.12d folder / About Emacs next >
Encoding:
Text File  |  1993-12-30  |  7.2 KB  |  156 lines  |  [TEXT/EMAC]
  1. This file accompanies an Apple Macintosh port of GNU Emacs 18.59.
  2. Here are some things to remember:
  3.  
  4. 1) This document describes differences between GNU Emacs on the
  5. Macintosh, and GNU Emacs on Unix.  It is not an introduction to Emacs.
  6. Type control-H t in Emacs to get an introduction.
  7.  
  8. 2) Emacs expects lines of text to end with '\n'.  The convention on
  9. the Macintosh is that lines of text end with '\r'.  To work around
  10. this, Emacs when reading files converts all '\r' characters to '\n'.
  11. Similarly, when writing files Emacs converts all '\n' characters to
  12. '\r'.  To accommodate this translation, and to allow Emacs to read
  13. other unconventionally formatted files, the following is done when
  14. reading any file:
  15.  
  16.     a)  If the file name ends with .elc or .bin, no translation is done.
  17.     b)  Otherwise, Emacs examines sequentially the first 200 bytes of
  18.         the file.  If a '\r' is found before a '\n', then the file will
  19.         be translated.  If a '\n' is found before a '\r', then the file
  20.         will not be translated.
  21.     c)  If neither a '\r' nor a '\n' is found, the file is translated.
  22.         This way, initially empty files will be translated and thus
  23.         conventional when later made non-empty.
  24.  
  25. The author of this port welcomes better ideas on heuristics that
  26. determine the need for translation.  See the final item below.
  27.  
  28. 3) The author's favorite Unix utilities have been ported in addition
  29. to Emacs.  These are ls, grep, ispell, and lpr.  Try them using dired,
  30. M-x grep, M-x ispell, M-x print-buffer, and M-x print-region.  You
  31. should uncomment the appropriate lines in .emacs to use ispell.  (The
  32. program sh is included so that wildcard characters used in arguments
  33. to ls, grep, and lpr can be expanded in the normal way.)  The programs
  34. chown, chmod, mkdir, and rmdir are included for use in dired mode.
  35.  
  36. 4) The function of the option key is determined by the variable
  37. option-is-meta.  If option-is-meta is nil, then the option key
  38. functions as is normal on the Macintosh, and you must use the escape
  39. key to enter certain commands.  If option-is-meta is non-nil, the
  40. default, then the option key functions as a meta key.  In this case
  41. you can still use command-option for a regular Macintosh option key.
  42. One quick way to set option-is-meta is from the “Special” menu.
  43.  
  44. In other implementations the meta key sets the high bit of any
  45. character typed.  On the Macintosh, the meta key prefixes each
  46. character typed with an escape character.  The resulting behavior is
  47. slightly different at times.
  48.  
  49. 5) Slashes in filenames within the Finder are translated to colons
  50. when referenced in Emacs.  Colons in filenames within Emacs are
  51. translated to slashes when referenced by the Finder.
  52.  
  53. 6) Emacs is System 7 dependent.  Emacs uses bit field instructions
  54. available only on the 68020 or later processors.
  55.  
  56. 7) Emacs has a 26 bit address space.  That's 64 megabytes.  If you
  57. have a Macintosh with more memory than that, Emacs will have to be
  58. deliberately loaded into low memory, through some kludge not yet
  59. developed.
  60.  
  61. 8) Keep your .emacs file in the same directory as the Emacs program.
  62.  
  63. 9) There should be a folder named “directories” in the same folder
  64. as Emacs.  The use of ~ in directory names is as follows:
  65.     a)  The directory “~emacs” is, by definition, the same one that the
  66.         Emacs program is in.
  67.     b)  If in the folder “directories” is an alias called “home”,
  68.         then ~/ is the folder targeted by that alias.  Otherwise ~/
  69.         is the same as ~emacs.
  70.     c)  For any other directory name ~dir, the folder understood
  71.         is the target of the alias “dir” in the “directories”
  72.         folder.
  73.  
  74. 10) For Emacs elisp hackers only: To start Emacs without loading the
  75. dumped elisp data, hold the shift key down when starting.  To rebuild
  76. the database, hold the option key down when starting.  It is a good
  77. idea to save a copy of Emacs before rebuilding its database, because
  78. Emacs saves its dumped data directly into its own resource fork.
  79.  
  80. 11) If Emacs suddenly quits on you, perhaps during garbage collection
  81. or byte-compiling, and perhaps with an error of ID 28, try using the
  82. "Set stack size..."  menu item to increase the stack size.
  83.  
  84. 12) Hackers may like working with the files in the directory lisp:mac.
  85. But remember this warning: If you start using the Macintosh Toolbox,
  86. you can easily, and will most likely, crash Emacs, and the entire
  87. machine, losing all changes in any open documents in Emacs and other
  88. programs.
  89.  
  90. 13) The commands in the Edit menu do the following:
  91.  
  92.     Undo calls the elisp function undo.  Unlike what is typical
  93.     on the Macintosh, successive undo's will undo more and more
  94.     of what has been changed in the buffer.  If you move the
  95.     cursor after successive undo's, the undo command will then
  96.     begin to successively redo what has been undone.
  97.     
  98.     Cut copies the region of the current buffer to the buffer
  99.     named *clipboard*, and also copies that region to the
  100.     System Scrap.  Then kill-region, more familiarly known as
  101.     control-W, is called.
  102.     
  103.     Copy is just like Cut, except that copy-region-as-kill,
  104.     more familiarly know as ESC-W,    is called instead of
  105.     kill-region.
  106.     
  107.     Paste insures that the buffer named *clipboard* contains
  108.     the contents of the Macintosh System Scrap, then inserts
  109.     the contents of the buffer *clipboard* into the current
  110.     buffer.  It does not call the elisp function yank, known
  111.     also as ESC-Y.
  112.     
  113.     Clear calls delete-region, and does nothing with the
  114.     Macintosh System Scrap.
  115.  
  116. These definitions are in lisp:mac:menus.el, and can be changed.
  117. The clipboard can be examined in the buffer named *clipboard*.
  118.  
  119. 14) Emacs can only use fixed-width fonts.
  120.  
  121. 15) Not all the elisp files included are immediately useful.  The
  122. files dealing with mail are not working, for example.  They are
  123. included for others who have a mail program and might try to make them
  124. work.
  125.  
  126. 16) Emacs handles correctly pathnames with aliases used as
  127. directories.  The pathname /HardDrive/Folder/AliasedFolder/File works.
  128. But pathnames with the final filename an alias work differently.  If
  129. /HardDrive/Folder/Alias is an alias to say /HardDrive/File, then you
  130. can open and edit that file using the alias.  When you save it,
  131. however, Emacs will first copy /HardDrive/File to
  132. /HardDrive/Folder/Alias~, then create rewrite /HardDrive/File.  This
  133. may or may not be what you want.  This is similar to what Emacs does
  134. under Unix with symbolic links.
  135.  
  136. 17) In dired, use the command 'O', which runs chown, to change the
  137. creator of a file.  Use the command 'M', which runs chmod, to change
  138. the type of a file.
  139.  
  140. 18) In TeX mode, C-c C-b (TeX-buffer), and C-c C-r (TeX-region) have
  141. been rewritten to send the appropriate Apple events to Textures.  The
  142. version of Textures required is 1.6.2.  You will need to edit the
  143. .emacs files to load the appropriate lisp code.
  144.  
  145. 19) Mouse support is at the moment limited to this: Clicking sets
  146. point, and shift-clicking sets mark.
  147.  
  148. 20) You can change the fonts available in the Font menu item by
  149. setting the variable fixed-width-fonts in your .emacs file.  The
  150. default value is ("Courier" "Monaco").
  151.  
  152. 21) This port is only moderately well tested.  It is a development
  153. version, still undergoing changes.  Save often.  Send bug reports,
  154. suggestions, and comments to the author of the port at
  155. parmet@cs.cornell.edu.
  156.